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NOTES ON PROGRAM LOADING 


All Interactive Microware programs are supplied either in DOS 3.2 
format or in a special "double boot" format which can be booted 
on either a DOS 3.2 (13-sector) or DOS 3.3 (16-sector) disk 
system. The label on the disk indicates whether the disk is 

DOS 3.2 or DOS 3.2/3.3 (double boot) format. If you are using the 
DOS 3.3 system, the programs can be converted from the DOS 3.2 
format, as supplied, to a DOS 3.3 format disk by using the MUFFIN 
program (on your System Master disk). For your convenience, the 
Programs are not copy protected; however, please note that the 
programs are copyrighted, so it is illegal to make copies, except 
for your own use. 


DOS 3.2 USERS: 


You should be able to boot, load, or copy programs from any of 
our disks labelled DOS 3.2 or DOS 3.2/3.3. 


DOS 3.3 USERS: 


If the disk is labelled DOS 3.2, you must boot your system with 
the BASICS diskette or mount the System Master disk and type 

BRUN BOOT13. Then, when the prompting message on the screen tells 
you to mount the DOS 3.2 (13-sector) disk, insert our program 

disk and press RETURN. 


If the disk is labelled DOS 3.2/3.3, turn off the computer and 
insert our program disk and turn the computer on. The DOS 3.2 
operating system is first loaded from our disk, and then the HELLO 
program is run on a DOS 3.2 system. 


To convert our programs to DOS 3.3 form, boot the DOS 3.3 System 
Master disk, type BRUN MUFFIN, and follow the instructions tc 
copy the desired programs to a disk that has been INITialized in 
DOS 3.3 format. 
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FEATURES OF VIDICHART 


Vidichart makes it easy for experimenters to input, display, 
compare and perform numerical operations on large sets of data. 
High-speed machine language subroutines control the high 
resolution display of up to four data sets of 1824 points, using 
a distinct plotting symbol for each. Under keyboard control, any 
of the four curves may be scrolled (non-destructively) to the 
left or right, up or down and the curve may be expanded or 
contracted in the X or Y direction. Two different cursors are 
provided: the tracking cursor follows along a plotted curve, 
whereas the free cursor can move anywhere on the screen under 
keyboard control. At any time, a printed report of the display 
Status may be superimposed on the bottom four lines of the 
Screen. This report gives complete information about the 
position of the left, right, top and bottom limits of the screen, 
scaling information, the position of the cursor and its value. 


But Vidichart is much more than just a fancy plotting 
program; it includes higher-level functions to facilitate input 
and output of data and to perform numerical operations on entire 
sets of data. Data may be entered from the keyboard, from a disk 
file or from an analoq to digital converter. Output of data may 
be directed to the screen, to a printer or to the disk. The 
straightforward format of the data stored on disk makes it easy 
to use data produced by other programs, such as the Scientific 
Plotter and Curve Fitter programs by this same author or many of 
your other programs. Utility functions of Vidichart permit you 
to determine the maximum value, minimum value or length of any 
data set, move selected data from one buffer to another or zero 
out some or all of the data values in a given data set, 

Numerical operations include addition, subtraction, 
multiplication or division of a data set by another data set or 
by a constant, differentiation, integration and N-point smoothing 
(i.e., moving average). 


Vidichart also includes some special functions which are 
useful for chromatography, spectrophotometry and other 
disciplines. A normalization function adjusts one data set to 
have the same average value as another data set. The baseline 
generator function allows you to define a baseline by using the 
free cursor to enter the end points of line segments. The peak 
integrator function automatically lists all of the maxima and 
minima for a curve and integrates each distinct peak. Several 
adjustable parameters may be used to fine tune the veak-finding 
algorithm. 


This manual explains how to use each of the many features of 
Vidichart and includes a series of demonstrations which will give 
you hands-on experience with this powerful and versatile set of 
data management tools. 
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HOW TO PRODUCE А BACKUP DISK 


Although this program is copyrighted, you have permission to 
make copies for your own use оп a single machine. Thus, your 
first action should be to copy the master disk to another disk as 
follows: 


1. This program is designed to run on a 48K Apple II 
computer with Applesoft in ROM. Mount the master 
disk, type RUN VIDICHART and then press RETURN (from now on, you 
should always press RETURN after entering a command.) After а 
short time, the screen will be erased, the copyright notice will 
appear and then the mini menu prompt '"1-IN/OUT 2-UTILITY 3=NUMERIC 
4=SPECIAL" with a flashing cursor at the end of the prompt. 


2. Type Control Q (hold down the CONTROL key and press the Q 
key) to stop the program. 


3. Mount your slave disk and type SAVE VIDICHART. 


4. Save the machine language part of the program by typing 
BSAVE VISIOBJ,AS8A@8,LS7F@. Тһе program actually uses all of the 
Space from 58408 to S95FF, but the highest 1024 bytes are used 
for data. 


CONTROL CHARACTERS FOR EDITING AND PROGRAM CONTROL 


Control H (back arrow) deletes the last character that you typed. 
Note that the right arrow key is ignored by this proqram while in 
text mode. 


Control X prints a back slash, advances to the next line and 
ignores the entire input line. 


Control G switches to Graphics mode so that you can examine or 
modify plots of your data, as described below. 


Control T causes Vidichart to return to Text mode so that you 
can enter a high-level function command. 


Control P allows you to select a Print device for subsequent 
output. After the Control P, type a single digit number denoting 
the slot occupied by the printer controller or type @ to restore 
normal screen output. 


Control D is the signal that the preceding command typed on the 
input line is a Disk Operating System [565 command. For 
example, typing CATALOG followed by Control D would list the disk 
catalog. You might also use this feature to delete or rename 
files, etc. A different drive, slot or volume may be selected by 
appending the new number to the CATALOG command. For example, 
CATALOG, D3, У18, S5 selects drive 3, volume 19 and slot five. 
Subsequent disk accesses will continue to use that disk. 
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Control Q means to Quit the program and return to BASIC. 
VIDICHART may be restarted at line 10 (GOTO 10) without 
destroying your variables. 


All other Control keys are ignored durinq user input in text 
made; however, Control S may be used to pause during screen 
output and Control C will stop the program (unless it is waiting 
for user input; see Control Q). 


TUTORIAL DEMONSTRATION OF DISPLAY OPTIONS 


Let's jump right into the heart of Vidichart with this 
hands-on demonstration. Type RUN VIDICHART (or just RUN if it is 
already loaded). First, we will load some sample data from the 
disk file called DATA] into buffer A. Mount the master disk and 
type CTRL U to turn off the prompts, then type 


LOD A 1 РАТА) 


Next, we'll load a different set of data (DATA2) into buffer B, 
Type: 


LOD В 1 DATA2 


The LOD command will be explained later; for now, let's just try 
the display. Type Control G to enter the Graphics mode. Hmmm. 
• . the screen just blanks out. Now, type 1 (or Control А) to 
select buffer A and then press P to Plot buffer A. Two hundred 
and fifty six symbols immediately appear on the screen. If you 
press P again, the symbols will disapppear. That is due to the 
way the display routines work; each time a point is drawn, it 
reverses the color of the screen at that position. This approach 
prevents one curve from erasing another as it moves around on the 
screen. Anyway, knowing how this works will help you to 
understand some other peculiar effects that may occur later under 
unusual circumstances. Press the P key again and hold it down 
while pressing the REPT key. This makes the display flash. You 
may find this flashing effect useful later, when the screen is 
crowded and you want to highlight one of the curves. 


Practice with Scrolling 


Next, press the left arrow key and note that the display 
shifts each symbol to the left and a new symbol appears on the 
right. If you press the left arrow key and the REPT key at the 
same time, the points continuously scroll to the left. Likewise, 
the right arrow key shifts each point to the right and the REPT 
key may be used for continuous scrolling. Use the semi-colon key 
(;) to shift the display down & the colon key (:) to shift the 
display up. Try the REPT key. Isn't that nice?  Four-way 
Scrolling of a graphics display! 


If you scroll buffer 1 (A) too far to the right, you will run 
out of points to display and then, you will see "garbage" on the 
left side of the screen. Likewise, if you scroll too far to the 
right, you will run out of points from buffer 1 and the rightmost 
points will actually be taken from buffer 2 (B). Bear in mind 
that the four buffers, 1 through 4, are packed right next to one 
another in memory. The display system does not check to make 
sure that you are paying attention to buffer boundaries. No harm 
is done when you exceed the limits of a buffer, as long as you 
understand what is happening. The Report command will help you 
keep track of where you are. 


A Position Report 


After moving the display around for awhile, you may forget 
where you started out. Press the R key if you want a Report of 
the display status. The bottom four lines tell you that BUFFER 
number 1 (A) is active and the SCALE factor 15 1. The number of 
the point displayed at the left edge of the screen is given after 
LEFT and the point on the right edge is shown after RIGHT. The 
value given after SKIP should be 1. This is the interval between 
the points being displayed; for example, if SKIP is 2, every 
second point is displayed. BOTTOM tells you the Y axis value of 
a hypothetical point plotted at the very bottom of the screen, 
while TOP gives the equivalent Y value for a hypothetical point 
plotted at the top of the screen. The OPFSET value tells you the 
number of steps the curve has been displaced above or below the 
original baseline. For example, if OFFSET is 10, the colon 
(up) key has been pressed 10 times; if OFFSET is -10, the semi-colon 
(down) key has been pressed 10 times. Let's ignore CURSRX, VALUE 
and CURSRY for now. Just for practice, why don't you try to 
reposition the curve at LEFTs8 and OFFSET=9. You will notice 
that the report disappears whenever you press any key, but you 
can quickly recall it by pressing R. 


Changing the Active BUffer 


Next, let's see what buffer 2 (or B) looks like. Press 2 (or 
Control B) and then P to Plot buffer 2. You will notice that 
the scrolling keys now work on buffet 2, instead of buffer l and 
the Report (try typing R) reflects the values for buffer 2. Only 
one buffer can be active at a given time, but you can promptly 
switch from one buffer to another by pressing any of the number 
keys from 1 through 4 or the corresponding Control keys from A to 
D. Buffers 3 and 4 are transparent now, because we haven't put 
any data in them. As the curves scroll past one another, they do 
not erase each other unless two points momentarily coincide. 


You will notice that the plotting symbols used for buffer 2 
are different from those used for buffer 1. There is a pattern 
here. Symbol 1 looks like an L; you may think of it as the hands 
on a clock showing 12:15. Symbol 2 is rotated clockwise 96 
degrees and looks like 6:15 on the clock. Symbol 3 is rotated 
clockwise again and looks like 6:45 and symbol 4 looks like 
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11:45. When symbols are plotted close together, overlap can 
cause parts of the symbols to disappear. This is due to the 
Screen color inversion technique used to plot the points; 
plotting the first symbol turns the points on, but an overlapping 
symbol may turn those points off again. 


Changing the Scale 


There is something peculiar about buffer 2. The heads are 
shaved off some of the peaks. Vidichart has another set of 
commands that allows you to change the scale for either the X 
axis or the Y axis. Press H and the height of the active curve 
is Halved. You can press H repeatedly and even use the REPT 
key, but the curve gets very small after a few times. To 
increase the height of a curve, press the D key to Bouble its 
size. When the curve reaches its original size, the D key no 
longer has any effect. The C and E keys perform a similar 
function, but they affect the X axis instead of the Y axis. 
Pressing C Contracts the curve, whereas the E key Expands the 
curve along the X axis. Again, you may press these keys 
repeatedly or use the REPT key, but eventually you will reach a 
limit, beyond which the curves cannot be compressed or expanded 
any further. With one exception (see the F command below), only 
256 points are shown on the screen for each buffer at any given 
time. 


If you press the R (Report) key, you can observe the effect 
of the D, H, E and C keys on the reported values. Note that each 
time you press C (and then R), the value of SKIP increases by 1; 
in other words, the interval between the plotted points 
increases. Conversely, the E key decreases SKIP. If SKIP is 
larger than 4, the points on the right side of the screen are 
from the next buffer; this is apparent from the fact that RIGHT 
is greater than 1023. In fact, at the maximum compression when 
(SKIP=16), all four buffers can be viewed at the same time. If OFFSET>0, 
you type H, the value of BOTTOM decreases and the value of TOP 
increases; in other words, the values attached to points plotted 
at the bottom and top of the screen are becoming larger in 
absolute magnitude. Conversely, pressing D will increase BOTTOM 
and decrease TOP. However, if the zero line is exactly at the 
bottom of the screen (OFFSETs0), the H and D keys always leave 
BOTTOM equal to zero, 


Filling in a Curve 


By this time, you may have noticed that when you Compress a 
curve, the spacing between adjacent points appears to increase. 
This is because the SKIP interval increases and some of the 
points are not plotted. You can Fill in the missing points by 
pressing the F key. This causes every point in the active 
buffer to be plotted. But replotting the points that were 
already on the screen erases them, so you should press P tomake 
them reappear. It is not possible to scroll more than 256 
points, though, so if you move the curve or change scale, only 
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256 points will move and the rest of the filled-in points will 
remain where they were (try this). Thus, before moving the 
curve, you may want to erase the other points by pressing F again 
(and also press P if necessary to make the original 256 points 
reappear). 


Erasing a Curve 


You already know that you can erase the active curve by 
pressing P. However, if you move the curve after erasing it this 
way, the curve will reappear double. This is because the 
previous curve (at its old position) is redrawn in the process of 
"erasing" it, and then the curve is drawn at its new position. 
This effect can be useful if you really want to have two copies 
of the same curve on the screen at the same time. 


A different way to erase the active curve is to press the X 
key. This zeroes out all memory of where the points were plotted 
previously, so pressing X again will not make the curve reappear. 
You will have to press P to replot the curve. 


If things get out of hand and you want to start over with a 
fresh slate, you can use the Y key to erase the entire screen. 
This works the same as repeated use of the X key on ever 
buffer. Now, you can replot each of the curves, one at a time, 
by typing 1P, 2P, etc. 


Using the Cursors 


Vidichart provides two different types of cursors. The 
"tracking" cursor follows from point to point along the active 
curve and is useful for determining the point number or the Y 
value of a particular point. The "free" cursor can move anywhere 
on the screen and is used to enter position information in both X 
and Y directions. For example, the free cursor is used for 
defining a baseline. To obtain information about the cursor 
position, press the R (Report) key. The bottom line now shows 
CURSRX, the point number in the active buffer where the cursor is 
resting. Also shown is the VALUE of Y for that point.  CURSRY is 
the same as VALUE for the tracking cursor, but if you are using 
the free cursor, CURSRY will tell you the equivalent Y value for 
that position on the screen. 


Now, let's see how to use the tracking cursor. When you 
press K (for Kursor), a small pius (*) sign appears at one 
position on the screen, right on top of one of the points of the 
active buffer. It may be hard to see the cursor if it is located 
at the bottom of the screen or in a congested zone, so try 
pressing the К and REPT keys at the same time. This capses the 
cursor to wink. Next, press the J key. This makes the cursor 
move to the left, whereas pressing L makes it move to the right. 
You can remember these keys by noting that they are on the left 
and right side of the K key. Also, they are close to the REPT 
key, so you can scan rapidly by pressing either key at the same 
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time as the REPT key. Try using REPT. When the cursor reaches 
the right edge of the screen, it jumps back to the left edqe and 
vice versa. You should also try the R key and see how the values 
of CURSRX, VALUE and CURSRY change as you move the cursor. 


The free cursor appears when you press the O key. The circle 
of the O should call to mind that the free cursor can move in any 
direction. Pressing O and REPT simultaneously makes the free 
cursor wink. The J and L and REPT keys may be used to move the 
free cursor to the left and right, but it doesn't track along the 
active curve, does it? You can also move the free cursor up by 
pressing I and down by pressing M. Note that these keys are the 
same aS the ESC keys used to move the cursor in Applesoft and 
that they form a logical cluster at right angles to the K key. 
Use the R key to get a Report of the cursor position and observe 
how CURSRX, VALUE and CURSRY change as you move the free cursor 
around on the screen. When you are through experimenting, type 
Control T to return to Text mode. 
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ALPHABETICAL SUMMARY OF DISPLAY OPTIONS 


Activate buffer A (1) 
Activate buffer B (2) 
Activate buffer C (3) 


Activate buffer D (4) 


Switch to Graphics mode 
Switch to Text mode 
Scroll active curve left 
Scroll right 

Scroll up 

Scroll down 

Repeat any key operation 


Compress X scale 
Double size on Y axis 
Expand X scale 

Halve size on Y axis 
Move free cursor up 
Move cursor left 
Select tracking cursor 
Move cursor right 
Move free cursor down 
Select free cursor 
Plot active buffer 
Erase active curve 


Erase entire screen 


HIGHER LEVEL FUNCTIONS OF VIDICHART 


Ihe following functions are available whenever you are in 
Text mode. If you are currently in Graphics mode, type Control T 
to enter Text mode. Each function is requested by a three letter 
command, followed by a space and one or more arguments separated 
by spaces. The type of argument is indicated by a $ sign for 
strings or a # sign for numbers. BUFS denotes a buffer letter 
from A to D, SUB# means a subscript between 0 and 1023 and other 
numbers, such as VAL#, must be integers between -32767 and 32767, 
except as noted. 


DESCRIPTIONS OF INPUT/OUTPUT FUNCTIONS 


PRT BUFS SUB1# SUB2# >Print Buffer Values 
e.g., РЕТ A 0 10 


The PRT function PRinTs the values contained in buffer BUFS 
at subscript positions SUBl4 through SUB2#. Тһе present 
subscript value is printed at the beginning of each line of five 
numbers. You may use the Control P command to obtain a hard 
copy. 


INP BUFS 50В1% VAL1L# . . . VALN# Input Buffer Values 
e.g., INP А 0 10 15 20 


The sequence of numbers VAL14 through VALN# will be stored in 
buffer BUF$, starting at position 5081%. Up to six lines of 
numbers may be entered, with a single space after each number. 


LOD BUFS SCALE# FILES  »Load Buffer from Disk 
е.4., LOD А 2.5 DATA 


This will LOaD successive values from disk file FILES into 
buffer BUFS, starting at subscript position zero. Each value 
will be multiplied by SCALE# (a floating point value is OK) 
before storing it. The purpose of this scale factor is to allow 
you to convert floating point numbers in a disk file to inteqers 
for use in this program, without significant loss of accuracy. 
For example, if your disk file contains numbers between -10.014 
and 20.650, you might use a scale factor of 1000 to convert them 
to a range of -10014 to 20650. As the numbers are stored, they 
are integerized, so any fractional part is lost. 


The format of disk files used with VIDICHART is very simole 
and is identical to that used by Scientific Plotter and Curve 
Fitter. The first item in the file is the number of values 
Stored in this file. Then come the values themselves. For 
example, if D(N) is an array of М values, the following program 


m. 


would create file F$, which is compatible with VIDICHART: 


100 PRINT CHR$(4)"OPEN "F$: PRINT CHR$(4)"WRITE "FS 
118 PRINT N: FOR I = 0 TO N-1: PRINT D(I): NEXT 
120 PRINT CHR$(4)"CLOSE "FS 


If a disk file contains more than 1824 numbers, only the 
first 1024 will be read. A missing file name will cause "FILE 
NAME ERROR" to be printed. If any other error occurs during a 
LOD operation, VIDICHART prints "ERROR CODE", followed by a 
number which refers to the error codes listed in the Applesoft 
manual (p. 81) or the DOS 3.2 manual (pp. 114-115). 


SAV BUFS SCALES FILES  »Save Buffer on Disk 
e.g., SAV A 1. DATA2 


The SAV command will SAVe all of the data from buffer BUFS on 
the disk as file FILES. Before each number is transferred, it 
will be multiplied by SCALE#, which may be a floating point 
number. If SCALES is one, the buffer values will be saved in 
their original form. If you want to switch disk drives before 
saving a file, you should type CATALOG, followed by the new drive 
(e.g., D2), slot and/or volume number and then type Control D. 


Here is a proqram that you could use to read a disk file (F$) 
created by VIDICHART into one of your own programs: 


200 PRINT CHR$(4)"OPEN "F$: PRINT CHR$(4)"READ "F$ 
210 INPUT N: FOR I = @ TO N-1: INPUT D(I): NEXT 
220 PRINT CHRS(4)"CLOSE "FS 


The error messages for SAV are the same as those for LOD. 


ADC BUFS CHANNELS SAMPLE# DELAY#  »Analoq to Digital Converter 
Input 


This function reads a number of samples (SAMPLE#) from a 
given Analog to Digital Converter channel (CHANNEL#) using a 
delay factor of DELAY#. The values are placed sequentially in 
BUFS$, starting at position 0. 


Since you could use any A to D converter for this function, 
VIDICHART allows you to customize the routine to suit your 
hardware, as described in the section entitled User Modifications 
of VIDICHART. However, in the meantime, you can test the ADC 
function using the APPLE game controls and the standard version 
of VIDICHART. In this version, CHANNEL# must be either 0 or 1 to 
Select one of the two game controls and DELAY# must be between 0 
and 32767 or else a RANGE ERROR will result. Set DELAY# to 50 for 
the first try or use a lower number for faster sampling. After 
you enter the ADC command, turn the dial on the selected qame 
control and you will see points plotted on the screen. If you 
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have requested more than 256 points, the plotter will jump from 
the right edge back to the left edge and erase the previous 
points as the new points are plotted. After the sampling is 
finished, VIDICHART replots the buffer with position 0 on the 
left side of the screen and returns to text mode. To view your 
handiwork, type Control G. 


EXPERIMENTING WITH INPUT/OUTPUT FUNCTIONS 


Just reading about these features gets pretty dry, so let's 
give these commands a test run. (If you have already tried them, 
that's great! Charge on and read about the Utility Functions.) 
If you haven't already fired up VIDICHART, type RUN VIDICHART. 


First, let's see what is currently stored in buffer C. Type 
PRT C Ø 10. All zeroes. Well, let's put something more 
interesting in there. Type INP C 0 0 10 20 30 40 50 66 70 80 90 
100. This places the numbers from 0 to 108 in buffer C, starting 
at position 0. To confirm that it worked, type РЕТ С 0 10. You 
might also want to check the plotted results (type Control G 3 P 
and then Control T to return to Text mode). 


Next, let's save this data on the disk. Mount your slave 
disk and type SAV C 1 ТЕ5ТІ. Since we're using a scale factor of 
1] here, the data will be stored without change. In order to make 
sure that file TESTI was actually saved, type CATALOG and then 
Control D.  TEST1 should be listed as a text file of 2 blocks. 
Now, how about loading this data into buffer D? Before loading 
the data, type PRT D @ 10 to verify that buffer D is empty at 
this time. Then type LOD D 2 TEST1. How will the scale factor 
of 2 used here affect the values in buffer D? Type PRT D 0 10 to 
see if you're right. 


It's time to have some fun with the ADC command now. I'11 
assume that you're using the standard version of VIDICHART, which 
uses the game controls for input. Tyne ADC А 0 5600 54 to read 
500 values from game control 0 with a delay of 50 and place the 
reults in buffer A. You should have your hand on the game 
control knob before pressing RETURN, because things happen quite 
rapidly once the action starts.  Twiddle the knob to make the 
curve rise and fall. After the program returns to text mode, 
type Control С to view the graph and scroll it around, compress 
or halve it. Type Control T when you are through playing around. 
You can repeat the ADC command as many times as you want to and 
experiment with changing the buffer, the channel number, the 
number of samples and the delay factor. With a delay of 0, you 
can sample at a rate of more than 50 samples per second. 


DESCRIPTIONS OF UTILITY FUNCTIONS 


LEN BUFS >Length of a Buffer 
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e.q., LEN A 


This prints the message, LENGTH = and then a number which 
tells the position (subscript) number of the last non-zero value. 
If values 1 through 1023 are all zero, LENGTH is reported as @, 
regardless of whether the value at position 0 is zero or nonzero. 


MAX BUFS »Maximum Value in a Buffer 
e.g., MAX B 


Prints the message, MAXIMUM = and then the number which is 
the largest of all numbers in the specified buffer. 


MIN BUFS > Minimum Value in a Buffer 
e.g, MIN С 


Prints MINIMUM s, followed by the smallest of all numbers in 
the buffer. 


MOV ВЏЕ15 SUB1# SUB24 ВПЕ25 SUB3#  »Move Buffer Values 
e.g., MOV А Ø 100 B 10 


The MOV command MOVes the values from subscript positions 
50В1% through SUB2# of buffer BUF1S to sequential positions in 
BUF2$, starting at subscript 5083%. If BUF2$ is the same as 
BUF1$ and SUB3# is less than SUB2#, the results will be 
incorrect, due to overlap. In this case, you must first move the 
data from ВОҒ15 to a different buffer, BUF3S (MOV BUFLS SUBI1# 
5082% BUF3S SUB1#) and then move the data from BUF3S back into 
ВОР15 (MOV BUF3S SUB1# SUB2# ВОҒ15 SUB3#). 


MVZ ВЏЕ15 SUB1# SUB2# BUF2S SUB3# >Move and Zero Remainder 
e.g, MVZ В 100 280 A 0 


MVZ performs just like MOV, except that after the transfer is 
completed, the remaining values (that is, those beyond the last 
value stored) in BUF2$ are set to zero. This is useful when you 
are moving values into a buffer that has already been used for 
something else and you want to clean up the garbage. 


ZRO BUFS 50814  »Zero Part of a Buffer 
e.q., ZRO C 209 


This stores zeroes in all values from 5081# onward in buffer 
BUFS. If SUB1# is less than zero, its value is negated (made 
positive) and then all values preceding that position in the 
buffer are deleted as the remaining values are moved down to 
Start at subscript 0. After this shift is completed, the unused 
part of the buffer is zeroed. For example, if buffer A contains 


01234500... and you issue the command ZRO А -3, buffer 
A will now contain 3 4 50 0. a ee 


POS BUFS SUB#  »Position the Plot of a Buffer 
e.g., POS A 10 


You may find it inconvenient sometimes to scroll a buffer to 
a particular position on the display screen. The POS command 
enables you to replot the display with a given data point (SUB#) 
at the left edge of the screen. Since this is a text mode 
command, you must type Control T to exit from graphics mode, type 
the POS command and then type Control G to return to graphics 
mode.  BUFS becomes the active buffer after the POS command. 


EXPERIMENTING WITH UTILITY FUNCTIONS 


Feel free to skip this section if the utility commands are 
completely clear in your mind. If you haven't already done so, 
type RUN VIDICHART and use the INP, LOD or ADC commands to enter 
some values in buffer A. 


Let's see how many values are stored in buffer A. Type LEN 
A. What is the maximum value? Type MAX A. And what is the 
minimum value in A? Type MIN А. You will notice that LEN 
returns a value almost immediately, but MAX and MIN take longer; 
their time is proportional to the length of A. This is also true 
of most of the other text mode functions. If you are working 
with large buffers of data, you'll have to be patient; BASIC is 
working its little heart out. While you're waiting, think about 
how long it would take you to do all of those calculations by 
hand. 


Next, we'll move some values from buffer А to buffer B. Туре 
PRT A 0 10 and then PRT B 10 20 to see what is currently stored 
in these buffers. Now, type MOV A 0 10 B 10. Check the results 
by typing PRT B 10 20. As an example using MVZ, let's move the 
same values from buffer A to position @ in buffer B. Type MVZ A 
ð 10 B 0 and then PRT B Ø 20 to verify that values 11 and onward 
are now zero. Another way to verify this is to use the LEN B 
command, which should return LENGTH=1@. 


We can continue using buffer B to demonstrate the ZRO 
function. First, type ZRO B 6 and then PRT В И 10. А11 of the 
values beyond position 5 should be zero now. If you type ZRO B 
-5 followed by PRT B @ 18 you will see that the value formerly at 
position 5 is now at position 0 and all of the other values are 
zero. 


The final demonstration concerns use of the POS command. 
Type POS A Ø and then Control С to enter Graphics mode. Next, 
type R for a Report and verify that LEFT is zero. Then, type 
Control T to return to Text mode. Where would you like to 
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position the display? Type POS A #, where # stands for any 
position number that pleases you. Go back to Graphics mode, 
observe the plotted curve and verify that the value of LEFT is 
the same as you requested. 


DESCRIPTIONS OF NUMERICAL FUNCTIONS 


ADD BUF1$ BUF2$ BUF3$ >Add Buffer Values 
SUB ВОЕ15 VAL# BUF2S >Subtract Buffer Values 
MUL BUFI1S BUF2$ BUF1$ >Multiply Buffer Values 


DIV BUFIS VAL# BUF1S >Divide Buffer Values 
e.g., DIVA 10.1 B 


These commands are presented as a group because their format 
and arguments are identical. The selected operation is performed 
on each value of ВЏЕ15, the first argument. The second argument 
сап be either another buffer (В0Ғ25) or a floating point constant 
(VAL#). If it is a buffer, the values stored at corresponding 
positions in BUFIS and BUF2$ are used for the operation. Тһе 
results are placed in corresponding positions in the buffer given 
as the third argument. Note that the third argument may be the 
same as the first argument. If any result is less than -32767, 
the value -32767 is stored and if any result is greater than 
32767, it is stored as 32767. Also, any fractional part of the 
result is truncated to an integer. 


DIF BUFIS BUF2S »Differentiate a Buffer 
e.g., DIF А B 


This command DIFferentiates (in other words, takes the 
derivative of) a buffer. After this operation, the first value 
in BUF2S is the same as the first value of BUF1S, the second 
value of ВЏЕ25 is the difference between the second and first 
values of BUF1$, the third value of BUF2$ is the difference 
between the third and second values of BUF1S, and so on. You may 
Specify the same buffer for both BUFIS and BUF2$. 


INT BUF1$ BUF2$ >Integrate a Buffer 
e.g., INT A B 


INT stands for INTegrate, which is just the opposite of DIF. 
The operation is performed by taking a running total of the 
values in ВОҒ15 and the current total is placed in the 
corresponding position of BUF2$. If the sum is less than -32767 
or greater than 32767, the closest integer value is stored in 
buffer ВОЕ 25, although the running total is carried accurately as 
a floating point number. It is permissible to select the same 
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buffer for both BUF1S and BUF2S. 


Notice that DIF and INT are reciprocal operations; that is, 
one undoes the other. For example, DIF A A followed by INT A A 
leaves A exactly as it was originally and vice versa. 


AVG BUFIS WIDTH# BUP2$ >Moving Average of а Buffer 
e.g., AVGA 10 8 


The AVG function computes the moving AVeraGe of WIDTH 
Successive values in ВЏЕЈ5 and stores the results in 
corresponding positions of BUF2$. Another name for this function 
is N-point smoothing, because it tends to smooth out bumps in a 
curve. Usually, the purpose of averaging is to smooth out random 
noise in a set of observations. 


If BUF2$ is the same as ВЏЕ15 or WIDTH# is greater than the 
length of BUF1$, the ARGUMENT ERROR message will be printed. 


EXPERIMENTING WITH NUMERICAL FUNCTIONS 


If you haven't already done so, type RUN VIDICHART to crank 
this program up. In order to simplify these examples and start 
with known data, let's first zero out buffers A and B (type ZRO A 
0 and then ZRO B 0). Then, type INPA 0 0 12 3 4 5, 


To exercise the ADD function, let's add 1 to each value in 
buffer А and put the results in buffer B (type ADD A 1 B). You 
should use the PRT function after each step of our procedure in 
order to verify that the results are correct. We can also add a 
buffer to itself and place the result in the same buffer (type 
ADD A A А). There аге no restrictions on the identities of the 
buffers used in the ADD, SUB, MUL and DIV functions. However, 
only the second buffer can be replaced by a constant. 


Here is a little puzzle for you: using only the SUB command 
only twice, how can you make buffer A and B identical (but not 
all zeroes)? From this point, you should be able to transform 
buffer B so that it contains 0 0 4 4 8 gin two steps, using the 
MUL command once and the DIV command once. The solution is in 
the next paragraph, so don't peek ahead unless you give ио. 


This is just a spacer to keep you from reading the answer 
prematurely. Just in case you're a fast reader and your eyes 
jump ahead here, it's not too late to turn back and try the 
puzzle. It's too late now; subtract 1 from B and leave the 
result in B. Then subtract B from A, leaving the result in A. 
Divide A (or B) by 2 and multiply the result by 4, leaving the 
result in B. Notice the effects of integer truncation during 
division. 


For practice with the DIF, INT and AVG functions, it helps to 
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have a fair-sized buffer with several peaks. Mount the VIDICHART 
master disk and type LOD A 1 DATA2. Then, type DIF A B. То view 
the results, type POS A ð and POS B Ø and then type Control С. 
Since some of the values in buffer B are negative, scroll curve B 
upward. You will notice that the derivative curve (B) has twice 
as many peaks as curve A. Also, the derivative curve changes 
sign at each peak or valley in curve A. Now, let's integrate 
buffer B and see whether the result is identical to A. Type 
Control T, INT B B and then Control G. Curve B will be updated 
if you erase it (type 2X) and then redraw it (type P). If curve 
B was scrolled upward previously, scroll it downward until it is 
superimposed on curve A. If they are identical, both curves 
should disappear when they are exactly aligned. However, due to 
the fact that different plotting symbols are used for the two 
buffers, some fragments of the symbols will remain on the screen, 


As our final exercise, we'll carry out ten point averaging on 
buffer A and place the result in B. Type Control T to get back 
in Text mode, then type AVG А 10 B. Type Control С and then 2XP 
to update curve B. You will notice that curve B is now smoother 
than curve A and the peaks and valleys are less sharp. When 
comparing complex curves like this, it helps to press P and REPT 
simultaneously, so that one curve blinks. 


DESCRIPTIONS OF SPECIAL PUNCTIONS 


МЕМ ВЏЕ15 BUF2S >Normalize a Pair of Buffers 
e.q., МЕМ А В 


The purpose of normalization is to correct for differences іп 
Scale when you are comparing two sets of data. This is most 
useful when the two buffers are quite similar in their pattern of 
peaks and valleys. The most straightforward way to normalize two 
curves is to take the ratio of the values of two corresponding 
maxima in the pair of curves and then multiply the lower of the 
two curves by this constant ratio. However, this approach 
suffers from the limitation that it relies on the accuracy of a 
single point from each curve. Moreover, on sharp peaks, it may 
be impossible to find a point which is exactly at the peak. 
Therefore, VIDICHART uses an improved method of normalization. 
Each of the two buffers is integrated over the same range of 
points and buffer ВЏЕ15 is then multiplied by the ratio of the 
two integrals, leaving the results in BUF1$. If the result is 
outside the range -32767 to 32767, the greatest integer value is 
Stored in ВЏЕ15. Since ВЏЕ15 is changed by the NRM operation, 
you should MOVe a copy of ВЏЕ15 to a different buffer if you want 
to save the original data. Also, note that it is usually 
desireable to choose the higher curve as BUF1S, since this will 
minimize integer truncation errors. 


Before normalization, it is important to ensure that both 
curves share the same baseline (zero point) and that the two 
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curves are aligned properly; that is, corresponding points in the 
two buffers should fall at the same positions in each of the two 
buffers. The BAS and SUB functions may be used to adjust the 
baseline and the ZRO function may be used to trim excess points 
off the left end of the longer of the two buffers. Excess points 
on the right end of one of the buffers do no harm, because the 
length of the shortest buffer is taken as the range of 
integration. All points in BUFIS are multiplied by the ratio of 
the two integrals, even when BUFIS is longer than BUF2$. 


BAS ВОЕ 15 BUF2$ >Define Baseline for a Buffer 
е.9., BAS A B 


In many cases, the baseline (or zero point) of a curve is not 
flat across the entire curve. When possible, it is a qood idea 
to evaluate the baseline exactly, store the baseline values in a 
second buffer and then use the SUB command to subtract the 
baseline curve from the data curve. However, sometimes it is not 
possible to evaluate the baseline directly, so it is necessary 
for the experimenter to estimate the baseline, based on the data 
curve itself. The BAS function is designed to help you with this 
task. ВОР15 is the buffer containing the uncorrected data and 
BUF 2$ will hold the baseline data after completion of this 
procedure. If the results are satisfactory, you should then use 
the SUB command to subtract BUF2$ from BUFIS. 


After you enter the BAS command, the program enters Graphics 
mode, В0Ғ15 is replotted with position 0 on the left edge of the 
screen and BUF2$ is zeroed. The program automatically invokes 
the free cursor, which should appear on the left side of the 
Screen. (Type O and REPT together to make the cursor blink). 

Use the I and M keys to move the free cursor up or down to define 
the starting position of the baseline. Then, type Control T to 
register that position. Now, use the I, J, L and M keys to move 
the cursor to the next endpoint of a straight-line segment of the 
baseline. Again type Control T to register that position, 
VIDICHART will interpolate a straight line between these points, 
store the results in BUF2$ and plot the line. Continue using the 
I, J, L, M and Control T keys to enter additional line segments 
until you approach the right side of the screen. If the curve is 
wider than 256 points, you will want to shift both the main curve 
and the baseline curve to the left now. VIDICHART assumes that 
this is what you want to do whenever you enter a cursor position 
that is to the left of the previous cursor position. In this 
event, both curves will be replotted so that the position of the 
cursor is at the left edge of the screen. In other words, if you 
want to shift both curves to the left, move the cursor leftward 
to the point that you want to occur at the left edge of the 
Screen and press Control T. The BAS procedure ends when you 
enter a cursor position beyond (to the right of) the end of the 
main curve. 


One precaution should be noted when using the BAS function. 
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The values of SCALE, OFFSET and SKIP should be the same for both 
curves (ВЏЕ15 and BUF2$), otherwise the baseline will not be 
plotted correctly. Use the R key to check this if you're not 
sure about these values or the baseline isn't plotted correctly. 
All of the graphic control keys work the same as usual while the 
BAS procedure is going on, so you are allowed to change the 
position, the X scale or the Y scale of the main curve (BUF1$). 
Just remember to make the same changes to the baseline curve 
(BUF2$). 


PEK ВОЁ1$ ВОЕ 2$ THRESH# WIDTH# CHANGER >Find and Integrate Peaks 
e.g., РЕК A B 10 20 30 


In chromatography, spectrophotometry and other disciplines, 
it is useful to integrate individual peaks within a curve. The 
PEK function searches for peaks in buffer BUF1$ and prints a 
report showing the positions of minima and maxima and the 
integral of each peak. To obtain a hard copy of the printed 
report, type Control P and a single digit slot number before 
typing the PEK command. A MINimum in the printout is defined as 
the first point that rises above the threshold. If the integral 
of the previous peak has not been printed yet, the integrated 
value is printed and a new integral is started with this point. 
A MAXimum in the printout is the point having the largest value 
within the current peak. A CUT means that the curve has gone 
below the threshold, so integration of the previous peak 
terminates and the integrated value is printed. The TOTAL of all 
integrated peaks is printed at the end of the listing. 


The cumulative integrals for each peak are stored in BUF2$ so 
that you can visually determine the limits of integration for 
each peak. To make a visual comparison, type Control G and align 
ВОЕ15 and BUF2S with equivalent corresponding points at the left 
edge of the screen. Reduce the Y scale of BUF2$ by typing H a 
few times. You should see a series of S shaped curves for BUF2$ 
and the end points of the S's should coincide with valleys in 
ВОЕ 1$. If you don't see a separate S curve for each peak іп 
ВОЕ15 ос the endpoints of the S's appear to come at the wrong 
positions, you may be able to improve the results by fine-tuninq 
the integration variables, as discussed below. 


The integration variables THRESH#, WIDTH# and CHANGES are 
optional; one, two or all of them may be omitted, The default 
value is 5 for each of them. THRESH# is the THRESHold for 
starting and ending the integration of a peak. It is assumed 
that values below this threshold represent the baseline or random 
noise. WIDTH# is the minimum width (number of points) recognized 
as a peak. The purpose of this variable is to filter out small 
noise spikes that occur at values above THRESH$ and are 
superimposed on a larger peak. If the number of points between 
the current minimum or maximum and the previous valid minimum or 
maximum is less than WIDTH#, the current реак will be iqnored. 
CHANGE# is the minimum change in height that must occur between a 
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peak and a valley in a valid peak. Its purpose is to decrease 
the sensitivity of the peak finding algorithm so that it doesn't 
find small peaks that barely get above the baseline and avoids 
false peaks due to noise excursions. 


EXPERIMENTING WITH SPECIAL FUNCTIONS 


If you haven't already fired up VIDICHART, type RUN 
VIDICHART. Mount the master disk and type LOD A 1 DATA]. 


For practice with the NRM command, let's create a new data 
set that is double the size of DATAl and then normalize them. 
Type MULA 2B. You can check the results by using PRT to print 
out some values or else by shifting into graphics mode and 
plotting the two curves. Next, type NRM A B. Again check the 
values in buffers A and B. The values in A and B should now be 
identical and buffer A should be twice as large as it was 
originally. Try changing some of the values in A or B and again 
normalize them. You will notice that the results are quite 
insensitive to small changes in one of the buffers, especially if 
the sum of the positive changes is about the same as the sum of 
the negative changes. 


We can use the same data to try out the BAS command. Type 
BAS А В. Press О and REPT at the same time so the cursor on the 
left side of the screen flashes. Use the I cr M key to move the 
cursor near to the bottom of the screen and type Control T. Now, 
move the cursor about 3 inches to the right (press L and REPT) 
and up or down a bit (I or M) and type Control T. A line will be 
drawn between the two endooints. Repeat this procedure until the 
baseline has grown to about an inch from the right end of the 
curve. Now, back the cursor up about an inch (J) and type 
Control T. Both curves will shift to the left so that the last 
inch from the right of the previous display is now on the left 
side of the screen. Now move the cursor to the right, past the 
last endpoint on the baseline and add more line seqments. When 
the last line segment extends beyond the last point on the main 
curve, the BAS procedure quits and the program returns to text 
mode. Next, type SUB A B C to subtract the baseline and place 
the results in buffer C. Switch to graphics mode and compare 
buffers A, B and C. You might want to use the POS command to 
line them up at corresponding positions. 


Our last experiment concerns the PEK function. We might as 
well use the curve in buffer C, which has a corrected baseline. 
This is the usual sequence of operations that you would follow 
with your own experimental data. Туре PEK С D. After awhile, a 
list of the MINima, MAXima and CUToff points will appear on the 
Screen, together with the INTEGRAL for each peak. Now, shift to 
Graphics mode and compare the inteqral curve (4) to the sample 
curve (3). Do the S's in curve 4 begin and end at the valleys in 
curve 3? Peel free to exoeriment with different values of the 
THRESH#, WIDTH# and CHANGES variables. How much change is 
required to significantly affect the integrated results? 
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SUMMARY OF VIDICHART ERROR MESSAGES 


If VIDICHART encounters a mistake in your command line, it 
will print one of these error messages, followed by a copy of 
your command with a question mark inserted at the location of the 
error. 


COMMAND ERROR: The first three letters of your command are not a 
recognized command. 


MISSING BUFFER: A letter from A to D was not found at the 
position where a buffer name is required. 


MISSING NUMBER: A numeric character was not found at the 
position where a number is required. Only the numbers from 0 
through 9, a decimal point, a minus sign or the letter E before 
an exponent are recognized as numbers. 


RANGE ERROR: A number outside the allowable range was detected. 
Subscripts must be between 0 and 1023 and other values must be 
between -32767 and 32767, 


FILE NAME ERROR: The file name is missing in a LOD or SAV 
command. 


ERROR CODE: An error occurred during a LOD or SAV operation. 
The number following this message refers to one of the codes 
listed in the Applesoft manual (p. 81) or the DOS 3.2 manual (pp. 
114-115). 


ARGUMENT ERROR: In an AVG command, either the number of points 
in the buffer is less than the number of points to be averaged or 
you have not selected two different buffers. 


REQUIRES 2 BUFFERS: The PEK command requires two different 
buffers. 
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USER MODIFICATIONS OF VIDICHART 
Adding Functions 


No doubt, some of you have some ideas for improvement of 
VIDICHART, These notes should help you to avoid some pitfalls. 
It is very important that you don't change anything below line 54 
in VIDICHART, because this will mess up the report that appears 
on the bottom four lines when you type R in graphics mode. The 
memory space for these lines falls right in the middle of the 
program. (If you list VIDICHART, you'll see some related qarbage 
in lines 38, 45, 49 and 53). 


Lines 90 to 99 are reserved for defining variables. All 
variables used by VIDICHART are listed here. Unless you are sure 
you understand what you're doing, avoid using these variables in 
any Statements you add to the program. 


It is fairly easy to add additional functions to VIDICHART. 
Let's assume that you want to add a function called NEG that 
NEGates each value of a buffer. (Of course, you could also do 
this by zeroing a buffer and then subtracting your buffer from 
the buffer containing zeroes.) Let's say you want to be able to 
put the result in a second buffer. Thus, a typical command would 
be NEG А B. All statement numbers above 1810 are available for 
your program, so we'll put it at 2000. First, you must change 
line 8020 to read 
800 IF CMS < > "РЕК" GOTO 2000 
and add line 2000 
2000 IF CMS < > "NEG" GOTO 42 
Note that all command names are 3 letters long and the first 
argument must be a buffer in all cases. After you type a 
command, the function name is returned in CMS, the first buffer 
number is in B0 and the length of that buffer is returned as N. 
The next task is to get the second arqument from the command 
line. In this case, we're expecting a buffer name again, so we 
will call subroutine 46, which returns the next buffer as BØ and 
the length of the buffer іп N. But we must first save BØ and N 
for the first buffer, so include the line: 

2010 Bl = BO: Nl = М: GOSUB 46 

All of the data for buffers is stored in an array called 
0%(1023,3), so buffer A has a second subscript of 8, B is 1 and 
50 on. The remainder of the NEG program is easy: 

2020 FOR N = Ø TO Nl: D$(N,BUO) = -D$(N,Bl1): NEXT 

We don't care about the length of the second buffer, so we can 
use variable N as a counter. In fact, once you have extracted 
all arguments from the command line, you can use any of the 
variables listed in line 91. On completion of any function, jump 
to line 10 to input the next command. 

2030 GOTO 10 
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Useful BASIC Subroutines 


Here are some subroutines that you may find useful: 


Subroutine 46 returns the name of the next buffer in BØ and its 
length in N. If the next argument isn't a buffer, it prints 
MISSING BUFFER and quits (jumps to 10). 


Subroutine 580 does the same as 46, but doesn't quit if the next 
argument is not a buffer. Instead, it returns RGz-l if it is a 
buffer and RG=Ø if not. 


Subroutine 54 looks for a numeric argument as the next item of a 
command. If a number is found, its value is returned as N and RG 
is set to l. Otherwise, RG will be @ on return. 


Subroutine 66 does the same as 54, except that it prints MISSING 
NUMBER and quits if the next argument is not a number. 


Subroutine 70 prints RANGE ERROR and quits if N is less than 0 or 
greater than 1023, the valid range for subscripts. 


Subroutine 74 prints RANGE ERROR and quits if N is less than 
-3.2767 or greater than 32767, the valid range of integers. 


Subroutine 80 may be used to switch to graphics mode but remain 
in BASIC. 


USR Argument Summary 


Most of the machine lanquage functions of VIDICHART are 
invoked by passing the Ascii value of the corresponding letter as 
the argument of the USR function. For example, U=USR(ASC("E")) 
or U-USR(69) will Expand the active buffer. This same approach 
will work for all other display options except those outlined 
here. Control A (Ascii 1) through Control D (Ascii 4) must be 
used to select the active buffer; the numbers 1 through 4 (Ascii 
49 to 52) are not recognized. USR(5) switches to graphics mode, 
not USR(7) as you might expect for Control G. After USR(5), the 
machine language program remains in control until Control T is 
typed. The P command is handled differently when called from 
BASIC. To replot the active buffer, the argument of USR must be 
256 plus the number of the point that you want to appear on the 
LEFT edge of the screen. To zero a buffer in the forward 
direction, the USR argument is 2848 plus the number of the first 
point to be zeroed. To zero a buffer in the reverse direction, 
the USR argument is -2048 minus the number of the first point to 
be kept. The length of a buffer is returned as U when you 
include the statement U=USR(B+9), where B is a buffer number 
between @ and 3. U=USR(@) initializes the display system, zeroes 
all buffers and clears the screen. 


The easiest way to learn how to use these USR commands is to 
study the examples in the BASIC portion of VIDICHART. Have fun, 
but please bear in mind that this program is copyrighted and 
should not be distributed to others in any form. 
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How to Use a Different Analog to Digital Converter 


This section explains how to adapt VIDICHART to use an A/D 
converter other than the game controls. Consult the instructions 
that came with your A/D board to determine the correct procedures 
for selecting the channel number, starting a conversion and 
retrieving a value. Usually, this will involve POKEing the 
channel number at a particular location, POKEing another location 
to start a conversion and then, after a suitable delay, PEEKing 
the sampled value at one location for an 8 bit converter or two 
locations for more than 8 bits. In the latter case, you will 
have to multiply the high order byte by 256 and add the low order 
byte. 


Now, let's look at subroutine 1008, which VIDICHART calls 
when you enter an ADC command. (List lines 1000 to 1018). 
Information from your ADC command is passed to subroutine 1000 in 
the following form: BÜ is the buffer to be used, OP is the 
channel number, NS is the number of samples to be taken and DLY 
is the delay between measurements.  GOSUB 80 switches to graphics 
mode and then U = USR(BO*1) + USR(-3071) activates BØ and zeroes 
the buffer. The ADC routine uses a special display option, the N 
(Ascii 78) command, which plots the Next point referenced by a 
counter stored at location XC (35365 decimal). This counter 
value is automatically updated by the N display option, so all we 
have to do is set the XC counter to 0 at the outset, Line 10945 
checks the value of OP and prints RANGE ERROR if OP is not a 
valid channel number. If your A/D converter requires a channel 
number, insert the code to select the channel here. 


The sampling is actually performed in line 1010, NS samples 
are read from the A/D converter and stored in the D$ array 
(0%(1,В0) = PDL(OP)). Typically, you should replace this 
Statement with a POKE to start the conversion and a PEEK to read 
the value and store it in D$(I,B0). Тһе U = USR(N) statement 
plots the current point on the screen, and erases the point 
plotted previously at that position on the screen. Next comes a 
delay loop (FOR J = 0 TO DLY: NEXT) to control the rate of 
sampling. If you are using a slow A/D converter, it may be 
necessary to insert this delay loop between the start conversion 
command and the read sample value command. After completion of 
the sampling loop, the buffer is replotted Starting at position 0 
(0 = USR(H)) and the subroutine returns after Switching to TEXT 
mode. This approach will support a sampling rate of uo to 54 
Samples per second. 
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VIDICHART UPDATE #1 


l. A "cueing" feature has been added to VIDICHART in order to 
remind you of the command formats. First, you select one of the 
four categories of functions (Input/Output, Utility, Numerical or 
Special Functions) by typing a number from 1 to 4.  VIDICHART 
then prints the three-letter names of all functions in that 
category, and you may select the desired function by typing the 
number preceding its name. Next, the function name is printed at 
- the beginning of the line, followed by a list of the arguments 
that you must enter for that function. If the argument name 
begins with a $ sign, your response should be a letter or group 
of letters. An argument name beginning with a # siqn should be 
answered with a number. You may enter all of the arguments at 
once, with a space between each argument and a RETURN at the end 
of the line. Alternatively, you may enter one argument at a time 
and press RETURN, in which case VIDICHART will prompt you if 
additional arguments are required. The correctness of your 
responses is not checked until all arguments have been entered, 
SO you may backspace (left arrow) to correct any errors that you 
detect before completing the list of arguments. To delete the 
entire command, type Control X. As usual, you may switch to 
graphics mode by typing Control G. 


2. After you become more experienced in using VIDICHART, you 
may wish to turn off the "cueing" prompts so that you can work 
faster. To do this, type Control U (for User cue). Later, if 
you get stuck and can't remember the syntax of a command, just 
type Control U again to return to "cueing" mode. In other words, 
Control is like a toggle switch that turns the "cueing" mode on 
or off. 


J. In the graphics mode, the R (Report) key has been changed to 
a toggle switch. Thus, after you type R, the report remains on 
the screen until you type R again or you type Control T to return 
to BASIC. It is quite helpful to watch the numbers change as you 
Scroll or change the scale. 


4. During the BAS function, the R (Report) switch is 
automatically turned on each time you enter a new point on the 
baseline, so that you can read the cursor position. You will 
usually want to turn the report off again by pressing R before 
you move the cursor to the next point on the baseline. 
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VIDICHART UPDATE #2 


A new "SAV" feature has been added which allows you to save 
and load data in binary files, rather than in text files 
normally used by VIDICHART. This speeds up disk accesses by 
more than a factor of 2. To select binary disk input or 
output, use £SCALE-0 in the SAV or LOD command (e.g., 

SAV А 0 DATA or LOD B @ BINARY). The binary SAV and LOD 
routines always save or load all 1924 points of a buffer, so 
you won't have to zero out the data previously stored there. 
The binary data on the disk is stored in high byte before 
low byte order, as usual for a BASIC array. Using the binary 
SAV routine, you can also save hi-res screen memory page 2 
(your graph) by choosing a file name starting with the 
letters PIC. This is handy if you want to print the picture 
using a graphics printer utility program. 


Only if you are using the Silentype version of VIDICHART, 
make the following change, which causes the program to 
terminate on Control S (not Control Q) when in the "cueing" 
mode. 


ТЕ C-19 THEN END 


Inthe "cueing" mode, you may abort a command at any time 
by typing Control X. 
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VIDICHART CHANGSS FOR USE WITH SILENTYPE PRINTER 


If you own a Silentype printer, the changes described below 
will enable you to print your graphs at the touch of a key, Also, 
you will be able to print the series of questions and answers 
that produced the graph, tables of results and other information 
that you wish to save. 


LOAD VIDICHART and type the following changes exactly: 


IF C € 22 БОТО 974 


IF C = 21 DOT) 379 

IF C = 13 THEN END 

IF С = 17 THEN POKE - 12529-2535: POKE - 12528,7: POKE - 12525,54: 
AIKE ~ 12924,0: PRINT CHRS (173 

nF C = 24 THEN PRINT CHRS (Co: POKE - 12523,0 

IF б > i13 6078 i4 

FOR С = 2548 TU 3824 STEP 128: FOR А = С TO C + 33: PRINT СНЕ (С PEEK 
(Ho — 1282: MEAT : PRINT : NEAT : 5070 18 


Now, save this modified version on your own disk (do not 
remove the write protect tab from the original disk). To use the 
printer, you must turn off the "cueing" prompts by typing CTRL U. 
Then, type CTRL P, followed by a single digit number that tells 
what slot your Silentype interface card is in. For example, 

CTRL Pl would select slot l. From this point on, each line that 
you type should appear both on the screen and on the printer. If 
the screen display (echo) is off, type CTRL T; each time you type 
CTRL T, the screen echo feature is toggled on or off. The PRT 
command does not TAB correctly unless the screen echo is on. 


After the printer is activated (by CTRL P), you may print 
your graph by merely typing CTRL 0. Помеџек, CTRL О is ignored 
by the display subsystem, so if you are in Graphics mode, type 
CTRL T to return to Text mode (in Graphics mode, CTRL T does not 
toggle the screen echo). You may also print the on-screen Report 
by typing CTRL R while in Text mode. To Stop VIDICHART, type 
CTRL S instead of the usual CTRL Q. 
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CHANGES IN SCIENTIFIC PLOTTER, CURVE FITTER AND VIDICHART 


FOR USE WITH EPSON MX-7% AND EPSON MX-80 PRINTERS 
AND FOR THE PKASO* PRINTER INTERFACE SERIES 


The changes below assume that you are using either the 
EP-12 parallel interface card (made by Interactive Structures, Inc.) 
or the GRAPPLER(tm) interface card (made by Orange Micro, Inc.). 
Both of these cards feature ROM routines that enable you to 
print the high resolution screen by typing just a few control 
characters. If you do not already own one of these printer 
interface cards, we highly recommend the new EP-12 card because 
it has special commands to print low resolution graphics, half- 
tone graphics, super high resolution graphics (960 x 792 points) 
and special characters and symbols defined by you. The EP-12 
also works with Pascal and CP/M systems, and it includes a 
DEMO DISK showing examples of all features. The price of this 
powerful interface card is only $175, and it is now available from 
Interactive Microware. 


For both Scientific Plotter and Curve Fitter, make the 
following changes for use with the EP-12 interface: 


2852 IF C=16 THEN GET C$: PRINT: PRINT CDS+"PR#"'+CS; 
PRINT CHR$(9)'"89P": GOTO 2810 


2858 IF C=17 THEN PRINT CHR$(9)'"15H": GOTO 2819 
2859 IF C218 THEN TEXT: END 


For the GRAPPLER interface, omit the PRINT CHR$(9)'89gP": 
in line 2852 and change "15H" in line 2858 to "G2". After 
making these changes, you can turn on the printer at any time by 
typing CTRL P, followed by a single digit number denoting the 
slot that your interface card is plugged into. If the printer 
is on, you can print the hi-res screen by merely typing CTRL Q. 
To stop the program, type CTRL R instead of CTRL Q (as in the 
manual). 

* For the PKASO series of interface cards (by Interactive 
Structures, Inc.), change "80P" to "I" and change "15H" to 
ti 33H" i 


Printer Changes for Epson Page 2 


The modifications for VIDICHART closely follow the 


changes deséribed in the manual for use with the mary reed $y | 
75, 


rinter. Thus, make the same changes in lines 32, 974, 
78 and 979, and alter line 976 and 977 as follow8: 


976 IF C917 THEN PRINT CHR$(9)"15H" (or "G2" for the GRAPPLER). 


977 IF C-20 THEN PRINT CHR$(9)"8gP" 


Bear in mind that you must turn off the "cueing" mode 

(type CTRL U) before activating the printer by typing CTRL P, 
followed by the slot number. When the printer is on, type 
CTRL Q to print the screen image and type CTRL R to print the 
report at the bottom of the screen. To stop the program, 

type CTRL 5. In text mode, typing CTRL T when thé printer is 
on will turn on the screen echo so that characters are printed 
on both the screen and the printer. 


VIDICHART EXAMPLES 


БАТА1 


BUFFER 00001 SCALE 00001 
LEFT 00000 RIGHT 00255 SKIP 00001 
00191 OFFSET 00000 


BOTTOM 00000 TOP 
CURSRX 00000 VALUE 00036 CURSRY 00000 


DATAl + DATA2 


BUFFER 00002 SCALE 00002 

LEFT 00038 RIGHT 00293 SKIP 00001 
BOTTOM 00002 TOP 00384 OFFSET-00001 
CURSRX 00038 VALUE 00044 CURSRY 00002 


x 
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APPLE COMPUTER, INC. MAKES NO WARRANTIES, 
EITHER EXPRESS OR IMPLIED, REGARDINE THE ENCLOSED 
COMPUTER SOFTWARE PACKAGE, ITS MERCHANTABILITY 
OR ITS FITNESS FOR ANY PARTICULAR PURPOSE. 
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